                          SMARTsort Release 2 - READ.ME
                          =============================


Welcome to SMARTsort.

SMARTsort Release 2 is a high performance and very flexible data
manipulation tool for workstations.  SMARTsort functions include:
SORT, MERGE, COPY, CHECK.  SMARTsort can process data that is
byte-oriented or record-oriented.  It can filter, restructure,
or summarize data during processing.

IMPORTANT:

   YOU ACCEPT THE TERMS OF THE IBM INTERNATIONAL PROGRAM
   LICENSE AGREEMENT BY YOUR USE OF THE PROGRAM.  PLEASE
   READ THE AGREEMENT (IplaSEng.Agr), ALONG WITH THE
   LICENSE INFORMATION (LInfoEng.txt), CONTAINED IN THIS
   PACKAGE BEFORE USING THE PROGRAM.


This READ.ME file contains information you need for installing
SMARTsort, as well as information that was not available for
our printed publication. This READ.ME file is divided into
the following categories:

    1) Before You Install SMARTsort
    2) Getting Help
    3) Installing SMARTsort
    4) Late-Breaking News
    5) Trademarks and Copyright Notices


Before You Install SMARTsort
----------------------------

   Software Requirements
   ---------------------

   OS/2 Warp 3.0, or any later version of OS/2, must be the base
   operating system installed on your system.

   The SystemView License Use Management runtime is required.
   Normally, you will need communications software, such TCP/IP or
   Netbios, installed on your computer.  Some recent OS/2 packages,
   such as OS/2 Server, include all the required software.  You
   should install the latest available version of this software.
   In the zip file containing this version of SMARTsort is included
   a version of SystemView License Use Management runtime under
   the subdirectory LicMgmt.  Its installation is independent of the
   installation of SMARTsort.  If you choose to install it, refer
   to the read.me in the LicMgmt subdirectory.  Be sure to complete
   the configuration actions required for this software after you
   install it.

   Hardware Requirements
   ---------------------

   Any IBM or IBM compatible 80386, 80486 or Pentium(tm) system
   that can run OS/2, can be used.  A minimum of eight megabytes of
   RAM (16 megabytes or more is recommended) is adequate for most
   SMARTsort applications.

   The amount of disk space required to execute SMARTsort depends
   upon the size of the files that SMARTsort will process.  The larger
   the file, the more disk space will be required.

   Note: SMARTsort can also be installed on a LAN (Local Area Network)
         Server, installation details are in the SMARTsort Guide and
         Reference for Workstations, SC26-7043-01.



Getting Help
------------

  Help is available in the following ways:

  1) Through the SMARTsort Guide and Reference for Workstations, in both
     hardcopy and  softcopy.  A displayable .INF file (using VIEW) is
     located in the \help directory after the product is installed.
     Also supplied, is this same document in postscript format; it is
     the file smartgr.ps.

  2) SMARTsort also has a Homepage on the World Wide Web at:

      http://www.storage.ibm.com/storage/software/sort/srtshome.htm

     The Homepage has information on accessing an FTP Server for
     softcopy editions of the SMARTsort Guide and Reference for
     Workstations in English, Spanish and Japanese.

     You can retrieve the English or Spanish versions by anonymous FTP
     to:

       lscftp.kgn.ibm.com/pub/smartsort

  3) For the first 60-days after purchasing SMARTsort, there is a
     toll-free Technical Assistance number you can call for installation
     and usage help: 1-800-237-5511.  Assistance is available
     8:00AM to 5:00PM, Monday thru Friday, excluding United States
     national holidays.  All Technical Assistance ends April 30, 1997,
     regardless of when SMARTsort was purchased.

  4) Program Services are available until April 30, 1997.  You can
     report code-related problems and documentation problems to IBM via
     electronic mail, facsimile (FAX) or U.S. mail.

     - Internet Email: use Talklink or CompuServe, call 1-800-992-4777
       for more information.
     - FAX: 1-800-426-8602
     - U.S. Mail:  IBM Corporation
                     Attn: Personal Systems Support Family
                     Mail Drop 2901
                     11400 Burnet Road
                     Austin, Texas  78758



Installing SMARTsort
--------------------

  To install SMARTsort, the installation files must be located in a
  directory \sortos2 on some drive.  If you initially unzipped the
  product file into another directory, then do the following:

     1. Create a directory \sortos2 on the same drive on which
        you unzipped the product file you originally received.
 
     2. From the directory in which you unzipped the product file,
        type the following three commands:

            move * \sortos2
            move i18n \sortos2
            move i18nmin \sortos2

  With the installation files in a directory \sortos2, type:

         x:\sortos2\install

  where x: is the drive where the installation files are located.

  NOTE: After installation, the system must be shutdown and restarted
        before trying to use SMARTsort.

  Except for the first step, the person responsible for License Use
  Management administration must perform the SystemView License Use
  Management steps described in the SMARTsort Guide and Reference for
  Workstations, Release 2, SC26-7043-01 (smartgr.inf or smartgr.ps).
  The supplied license information file (smrtsort.lic) is complete.
  You do not have to edit the file, as described in the first step.
  The file is your authorization to use the product, under the
  licensing control.  You must keep this file as you would a valuable
  asset; you must not leave it where it could be accessed by persons
  not legally responsible under your license.

  NOTE: This package does not define a method of creating diskettes
        from which SMARTsort could be installed.  However, the
        license management software, included under the LicMgmt
        subdirectory, must be copied to, and installed from,
        diskettes (See read.me in LicMgmt directory).



Late Breaking News
------------------

-- If you see the following message:

    SYS1804: The system cannot find file SDLL

   then the problem is that you do not have SystemView for OS/2
   installed on your system.  SystemView License Use Management must
   be installed to use SMARTsort.


-- The "Locale files" that can be optionally selected for installation,
   are also installable by other products as sharable.  If they have
   been installed, SMARTsort will not install them again.  If, after
   SMARTsort installation has completed, you request that SMARTsort
   delete the Locale files, they will not be deleted because another
   product could be dependent upon them.


-- Additional Install Parameter for LAN Installation

     The /S: parameter can be required on the INSTALL command
     when doing a LAN installation.  The requirement for this
     parameter is missing from the "Installation Program Parameters"
     topic of the "SMARTsort Guide and Reference for Workstations"
     book, Chapter-3.  The requirement is:

       /S:sd    required if the source files for the installation
                 are not in the /sortos2 directory of the drive
                 where install is invoked.  sd is the fully qualified
                 path; for example, w:/images/smrtsort.  This
                 parameter overrides the HOSTLOC parameter of
                 the PACKAGE statement of the SMRTSORT.ICF file.


-- Access to SMARTsort Installed on a LAN

     If you have users who will access SMARTsort on a LAN logical
     drive, the following are corrections to the information given
     under the topic "OS/2 LAN Installation Considerations" in
     Chapter-3 of the "SMARTsort Guide and Reference for
     Workstations:"

       1) The SMRTDESK utility is located in the /exe subdirectory
          of the directory in which SMARTsort is installed on the
          LAN.

       2) An additional installation action, not handled by SMRTDESK,
          is required for each LAN user.  You must provide a way for
          each user to access the I18N locale support.  Refer to the
          information in I18NINST.DOC in the I18N or I18NMIN
          subdirectory where the SMARTsort installation files are
          located.  You will have to choose whether each user should
          install the I18N support on their computer, or whether you
          should provide a way to update each user's CONFIG.SYS to
          access the I18N support on a LAN logical drive.


-- There is a change to the seventh parameter of the program
   invocation interface of SMARTsort.  Also, the SmrtCln
   interface is changed.  You can see the changed definitions
   in the smrtsort.h header file.

   Previously compiled programs will continue to run.  If you
   previously used smrtsort.h and coded an explicit linkgage
   pragma or IMPORT of SMARTsort, then you will have to change
   so that smart_sort is used.  It is preferrable that you
   remove the pragma or IMPORT.  Instead, use smrtsort.lib
   when you link.


  License-related Trouble Shooting
  --------------------------------

  Where is SystemView License Use Management documentation?

      See the publication:

        SH19-4187 License Use Runtime Administrator's and User's Guide

  Problem: SMARTsort will not start (the SMARTsort program will not
  load)

      The license management client libraries are not accessible on the
      machine on which you are running SMARTsort

  Problem: SMARTsort terminates with message "5026-070 Attempt to access
  SMARTsort license failed. Error reported is: SMARTsort OS/2: No servers
  available for this vendor (network license server/library)"

      The license management client has not been configured or
      does not specify the correct server machine, or

      The license server is down, or

      The network connecting your machine to the license server
      is down, or

      No license server has been defined on your network

  Problem: SMARTsort appears to hang or there is a long delay each time
  SMARTsort is started

      A server daemon is experiencing difficulties on a license server
      machine in your network.  The license management server on the
      machine experiencing difficulties needs to be stopped and restarted

  Problem: SMARTsort terminates with message "5026-070 Attempt to access
  SMARTsort license failed. Error reported is: SMARTsort OS/2: License
  not found in database (network license server/server)"

      The SMARTsort compound license certificate has not been
      installed on a license server accessible from your machine, or

      The license administrator has not yet distributed licenses for the
      number of concurrent-access users purchased

  Problem: Licensing-related network traffic is suspected of causing
  performance degradation

      Consult the license management documentation.  Configuration
      actions, such as the following, may be appropriate:

         - Providing local location brokers on each client machine

         - Providing additional license servers

         - Partitioning use of license servers in your network, so that
           organizations with a high volume of license request traffic
           are in their own "cell"


Trademarks and Copyright Notices
--------------------------------

Licensed Materials - Property of IBM
5622-427
(C) Copyright IBM Corp. 1994, 1996
All Rights Reserved.
US Government Users Restricted Rights - Use, duplication or
disclosure restricted by GSA ADP Schedule Contract with
IBM Corp.
